Floating Licence Upgrade Process

When using the Tektronix floating licence system based around the DK2 dongle and DESnet software, the supplied dongle comes pre-programmed with the number of licences requested. If the number of licences needs to be increased (for example, to support more concurrent users), there is a defined process that must be followed to enable the dongle to be remotely updated.

The general process that is initiated when you request more licences for your DK2 dongle from your Tektronix representative is as follows. The representative will ask you to generate Customer Update Request File (CURF) which will contain encrypted data unique to the dongle to be upgraded. You can generate the CURF on the license server hosting the dongle using a supplied utility. The CURF will then be used by the Tektronix representative to generate a unique licence update file (LUF) which you will use to upgrade the dongle.

NOTE. The licence update file will only work with the dongle used to generate the CURF. When the dongle has been upgraded, the LUF will become obsolete.

The remainder of this section describes the generation of the CURF.

Requesting and Applying a Licence Update

This following description assumes that the client machine has already been set up and can correctly connect to the license server machine. If there is no floating licence system supplied and you are upgrading from a single user, node-locked licence, then please contact your Tektronix representative.

Generating a Customer Update Request File (CURF)

  1. From the client machine, open the control panel (Start > Settings > Control Panel).
  2. Open DESkey application. In the DESkey Configuration dialog box, select the Networking tab.
  3. The server machine should be listed in the upper panel.

  4. Select the Monitor button to display the DK2 Network Server Remote Monitor dialog box.
  5. Highlight the server machine in the server list (upper panel) and select the Admin button. Enter the required password. The default is "deskey";.
  6. If the password is correct, the DK2 Network Server dialog box is displayed. Select the License Request tab.
  7. Enter the required number of licences in the requested edit box. The requested licences plus the current count cannot exceed 255.
  8. Press the Get Request button to generate the data for the Customer Update Request File. The collected data is shown in the panel next to the button and the Save to File button is enabled.
  9. Select the Save to File button and select a location and filename for the data. Any name can be used but the file must have a ".req" extension: "update.req" is the default.
  10. Close the DK2 Network Server, DK2 Network Server Remote Monitor and DESkey Configuration dialogs.
  11. The generated CURF must now be sent to your Tektronix representative; this can be done using email.

    Documentation describing the installation and implementation of the resultant License Upgrade File will be supplied separately.

Advanced Floating Licence Configuration

This section describes the features of the floating licence system which are relevant to the MTS4EA. The main entry point for managing the licence server and dongle is the DESkey applet which is available via the Windows control panel.

DESkey Control Panel Tabs

The DESkey Configuration dialog box contains three tabs. Only the first two of the three tabs (DK2/DK38 and Networking) are relevant to using network dongles. The final tab (File Versions) is purely for listing the version numbers of the various DESkey components.

The lower half of the DK2/DK38 tab contains the Access Method options which tell the DESnet driver to look for dongles locally, on the network or both. The option to change the order of the search is only available if both local access and network access are selected.

The upper half of the Networking tab contains the controls to configure the dongle servers to include in the licence search. The Edit, Remove and Add buttons are self explanatory.

In the case of multiple servers in the list, the order in which the entries are shown is also the order in which they are searched with the first item (top) being searched first. The search order can be changed at any time by selecting an entry and clicking the up or down arrows to promote or demote the entry.

The Monitor button allows the selected server to be remotely inspected to show how many licences are currently being used and by who, and how many are available in total. This also allows new licences to be requested and administered by the user.

The lower half of the Networking tab contains the setting for the Network Service if the machine is being used as a dongle server and it has the DESnet service installed. For machines that do not need dongle server capability, the network service will not be installed and these lower controls will be disabled.

For a machine acting as a server the service must be started either automatically on start-up or manually using the Start button. The Server Port Number is the port number that any client must use when communicating with the license server. The server port number must be one that is not blocked by any running firewall (The network administrator will advise with a list of suitable ports). If the port number is changed, press Apply button immediately afterwards; this will restart the service if it is already running.

DK2 Network Server Remote Monitor

When launched by selecting the Monitor button on the Networking tab of the DESkey Configuration dialog box, the DK2 Network Server Remote Monitor will query each machine listed in the control panel and retrieve information on any servers running. The basic information also includes a list of currently logged in users.

The selected server can be remotely administered by selecting the Admin button. The default password is "deskey" but this can be changed by the user using the DK2 Network Server Remote Administration dialog box.

DK2 Network Server Remote Administration

The DK2 Network Server can be administered from any other network accessible machine that has suitable DK2 drivers installed.

General Settings.

On the General Settings page the following server properties can be modified:

Connection Monitor: When enabled, this value specifies the maximum length of idle time the server will expect from any user. If the user has not accessed the server in this period they will be automatically logged off from the server without warning, even if the protected software is still running.

DK2 Licence Settings: When enabled, this value allows a user definable limit to be placed on the number of available users licences in the DK2 Network Server. This limit can be configured to a maximum of the licence count in the DESkey or 255, whichever is less.

Logout: If a user is selected, the option to force their logout from the server is available. The user will not be warned when they are logged out from the server. This can be used in place of the connection monitor to be more selective when removing users.

Refresh: This will refresh the monitor window with the latest information from the server.

Change Password: Allows the password required to remotely administer the DK2 Network Server to be modified.

User Validation.

The DK2 Server Monitor is also used to configure the User Validation of the DESkey Network Server. When used, only users entering the correct username and password will be granted access.

Once added, options allow users to be either disabled or deleted. A user can be disabled by clearing the Allow Logon box. A user can be deleted by selecting the Delete button. Any changes made to the user validation options will not be applied to the server until the OK button has been pressed. Disabling is different from deleting in that the user may be restored at a later date and any options will be retained.

The validation file is stored on the machine currently being monitored, (not necessarily the local machine.) Prior knowledge of the directory structure on the remote machine is required if the locations of the file is changed from the default directory.

The user's login password can be changed at any time by entering the new password into both the 'Password' and 'Confirm' boxes and by clicking 'Set Password'. If enabled, any user trying to access the server will be prompted to enter his or her username and password.

Licence Request.

The number of concurrent users that can access the DK2 Network Server is controlled by the number of DESnet licences within the DESkey. If additional DESnet licences are required to support more users, they can be requested and added from this page.

Licence Recall.

This page is currently not supported.

Troubleshooting the License Update Process

Here is a list of some common problems, if these do not solve the problem, contact Tektronix support.

The required license server machine is not listed on Networking tab
Add the server name using the Add button.
A license server machine is listed on Networking tab but is not listed in DK2 Network Server Remote Monitor dialog.
Has the server entered in the client’s list of servers been "applied". Select Apply on the DESkey configuration dialog and refresh the Monitor dialog.

Is Server service running on server? If not, start it.

Is port number the same on both client and server and not blocked by the network firewall? Select a suitable port number and apply it to both client and server.
New server port number is not being accepted by the Networking tab.
Stop the service by pressing the Stop button. Change the port number and press Apply. Start the service.
Pressing "Get Request" button on Licence Request tab causes "Error 8000 calling server".
Ensure that there is a dongle present on the server machine.
Pressing "Send Update" button on Licence Request tab causes "Error 4012 occurred sending update to server".
Ensure that update file (LUF) is for the dongle present in the server machine. Ensure that the file has not already been applied – it will only work once.